home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_usrdoc / ISAPNPTO.{13 / README.{_2 < prev   
Text File  |  1999-09-17  |  8KB  |  222 lines
  1.     ISA PnP utilities Version 1.18
  2.     ==============================
  3.  
  4. These programs allow ISA Plug-And-Play devices to be configured
  5. on a Linux machine.
  6.  
  7. This program is suitable for all systems, whether or not they
  8. include a PnP BIOS. In fact, a PnP BIOS adds some complications
  9. because it may already activate some cards so that the drivers
  10. can find them, and these tools can unconfigure them, or change
  11. their settings causing all sorts of nasty effects. If you have
  12. (for example) plug and play network cards that already work, I
  13. suggest you read the manual page isapnp.conf(5) on the format
  14. of the configuration file very carefully.
  15.  
  16. See the example for a dataflex voice fax modem and NE2000 clone
  17. PnP card in README.modules. See the section below on Drivers and
  18. MODULES for more background information. For even more hints etc
  19. see the FAQ at:
  20.  
  21.  http://www.roestock.demon.co.uk/isapnptools/isapnpfaq.html
  22.  
  23. The commands have been taken from the Plug and Play ISA
  24. specification Version 1.0a, widely available on the net.
  25. (ftp://ftp.microsoft.com/developr/drg/Plug-and-Play/Pnpspecs/PNPISA.EXE -
  26. this is a self-extracting DOS archive of PNPISA.DOC - a
  27. word 6 document. If Word 6 not available, use the freely
  28. redistributable viewer wordview which comes on the Win95 CD).
  29.  
  30. See CHANGES for a list of changes from the previous version.
  31.  
  32. See README.OS2 for description of OS2 stuff.
  33.  
  34. Installation intructions
  35. ========================
  36. See the file INSTALL.
  37.  
  38. Format of pnp configuration file:
  39. =================================
  40. See the manual page isapnp.conf.5.
  41.  
  42. If you have a problem:
  43. ======================
  44. Please start by looking at ALL the documentation provided, including
  45. the FAQ, then look at the isapnptools website at
  46. http://www.roestock.demon.co.uk/isapnptools/
  47.  
  48. Drivers and MODULES
  49. ===================
  50. Note that boards first configured by isapnp are not visible to the kernel
  51. during boot up. This means that drivers for the boards must be loaded
  52. as modules after the board has been configured, so that they can
  53. locate the board. See README.modules for an example.
  54.  
  55. This doesn't apply to serial cards, because setserial can be used to
  56. configure the serial ports after the kernel has booted.
  57.  
  58. Also, IDE devices can be initialised after the kernel boots by
  59. configuring IDE-PCMCIA in the kernel. Then writing a module to
  60. initialise the device after running isapnp.
  61. See README.ide and /usr/src/linux/Documentation/Configure.help.
  62.  
  63. An alternative method is to use initrd to run isapnp before booting
  64. the main kernel. See README.initrd and /usr/src/linux/Documentation/initrd.txt.
  65. This may be particularly applicable for IDE devices attached to PnP cards.
  66. I hope to experiment with initrd sometime for my network card...
  67. if you've already done it please tell me how.
  68.  
  69. If you boot Linux from DOS using loadlin, you can also run the DOS
  70. version of isapnp before booting Linux. This would allow you to use
  71. normal compiled in drivers.
  72.  
  73. If the kernel needs rebooting after configuration, because the drivers
  74. are not modules, it may be possible to do this automatically in your
  75. bootup scripts: use an isapnp.conf file which dumps the board
  76. configuration registers and tests the the output.
  77. If the board(s) haven't been configured, configure them with the
  78. configuration isapnp.conf file and reboot.
  79. If the boards have been configured, continue the boot normally.
  80. You may want to take precautions to prevent the kernel continuously
  81. rebooting if something goes wrong...
  82.  
  83. isapnp for debugging.
  84. =====================
  85. This example shows how the PEEK command may now be used with the standard
  86. configuration settings to dump the actual board configuration register
  87. settings, for example, the script:
  88.  
  89. #(DEBUG)
  90. (READPORT 0x3bb)
  91. #(READPORT 0x203)
  92. (ISOLATE PRESERVE)
  93. (IDENTIFY *)
  94. (CONFIGURE DFX0000/1493
  95.         (LD 0
  96.                 (IO 0 (PEEK)) # Dump Port 0
  97.                 (IO 1 (PEEK)) # Dump Port 1
  98.                 (IO 2 (PEEK)) # Dump Port 2
  99.                 (INT 0 (PEEK)) # Dump INT 0
  100.                 (DMA 0 (PEEK)) # Dump DMA 0
  101.                 (DMA 1 (PEEK)) # Dump DMA 1
  102.                 (MEM 0 (PEEK)) # Dump MEM 0
  103.                 (REG 0x60 (PEEK)) (REG 0x61 (PEEK)) # Dump Port 0
  104.                 (REG 0x62 (PEEK)) (REG 0x63 (PEEK)) # Dump Port 1
  105.                 (REG 0x64 (PEEK)) (REG 0x65 (PEEK)) # Dump Port 2
  106.                 (REG 0x70 (PEEK)) (REG 0x71 (PEEK)) # Dump INT 0
  107.                 (REG 0x74 (PEEK)) # Dump DMA 0
  108.                 (REG 0x75 (PEEK)) # Dump DMA 1
  109. ))
  110. (WAITFORKEY)
  111.  
  112. produces the following with my dataflex modem:
  113.  
  114. Board 1 has Identity 6e 00 00 05 d5 00 00 d8 10:  DFX0000 Serial No 1493 [checksum 6e]
  115. Peek(DFX0000/1493)[0][0x60](IO  0) is 0x03E8, (3,232)
  116. Peek(DFX0000/1493)[0][0x62](IO  1) is 0x0000, (0,0)
  117. Peek(DFX0000/1493)[0][0x64](IO  2) is 0x0000, (0,0)
  118. Peek(DFX0000/1493)[0][0x70](INT 0) is 0x0C02, (12,2)
  119. Peek(DFX0000/1493)[0][0x74](DMA 0) is 0x04, (4)
  120. Peek(DFX0000/1493)[0][0x74](DMA 0) is 0x04, (4)
  121. Peek(DFX0000/1493)[0][0x40](MEM 0) is 0x0000000000000000, (0,0,0,0,0,0,0,0)
  122. Peek(DFX0000/1493)[0][0x60](-REG-) is 0x03, (3)
  123. Peek(DFX0000/1493)[0][0x61](-REG-) is 0xE8, (232)
  124. Peek(DFX0000/1493)[0][0x62](-REG-) is 0x00, (0)
  125. Peek(DFX0000/1493)[0][0x63](-REG-) is 0x00, (0)
  126. Peek(DFX0000/1493)[0][0x64](-REG-) is 0x00, (0)
  127. Peek(DFX0000/1493)[0][0x65](-REG-) is 0x00, (0)
  128. Peek(DFX0000/1493)[0][0x70](-REG-) is 0x0C, (12)
  129. Peek(DFX0000/1493)[0][0x71](-REG-) is 0x02, (2)
  130. Peek(DFX0000/1493)[0][0x74](-REG-) is 0x04, (4)
  131. Peek(DFX0000/1493)[0][0x75](-REG-) is 0x04, (4)
  132.  
  133. Bugs
  134. ====
  135. I haven't tested the Memory setting stuff, as I haven't
  136. got a card with suitable drivers. If it doesn't work, tell me,
  137. and work around using poke, which I have tested.
  138.  
  139. The config option to pnpdump is experimental, and
  140. doesn't always produce non-conflicting output.
  141.  
  142. Newer PCs don't always work, I now think this is due to faulty
  143. hardware, see the FAQ for details.
  144.  
  145. Note
  146. ====
  147. These programs must run as root, as they need unrestricted access
  148. to the computer IO addresses. This could cause lots of problems,
  149. so use with care. DO NOT MAKE THESE PROGRAMS SUID root !
  150.  
  151. This is particularly important now that pnpdump (with certain options)
  152. uses popen() to invoke external programs.
  153.  
  154. Copyright
  155. =========
  156. These programs are copyright P.J.H.Fox (fox@roestock.demon.co.uk)
  157. and distributed under the GPL (see COPYING).
  158.  
  159. If mailing patches, bug reports or comments, please put 'isapnp'
  160. somewhere in the subject line, and mail to isapnp@roestock.demon.co.uk.
  161.  
  162. Warranty
  163. ========
  164. There is NO WARRANTY for these programs.
  165.  
  166. These programs have been compiled on my machine using gcc 2.7.2.3,
  167. flex 2.5.4 and linux 2.0.36, with libc-5.4.44 and they seem to work
  168. for me.
  169.  
  170. However, due to the nature of these programs, they are very likely
  171. to completely screw up your computer: USE AT YOUR OWN RISK. But if
  172. you find them useful, or have some suggestions for improvement,
  173. please tell me.
  174.  
  175. Credits
  176. =======
  177. Thanks to the following for bug reports, fixes, improvements and
  178. suggestions for improvement to isapnptools.
  179.  
  180. Bob Clark <rlc@hrb.com>
  181. Neal Sanche <neal@nsdev.ocunix.on.ca>
  182. Karsten Keil <pnp@temic-ech.spacenet.de>
  183. Jim Studt <jim@federated.com)
  184. Kevin Brooks <kb10@onyx.net>
  185. Jeff Epler <jepler@inetnebr.com>
  186. Markus Gutschke <gutschk@uni-muenster.de>
  187. Andy Sewell <puck@pookhill.demon.co.uk>
  188. Rildo Pragana <rpragana@acm.org>
  189. Richard Henderson <rth@cygnus.com>
  190. Kai Dupke <dupke@koma.han.de>
  191. Ken Walsby <kwalsby@ttransit.co.uk>
  192. Rick van Rein <vanrein@cs.utwente.nl>
  193. James S. Blachly <jblachly@ns.insolwwb.net>
  194. Steffen Kremser <kremser@nukunuku.swb.de>
  195. Adam J. Richter <adam@yggdrasil.com>
  196. Norbert Klasen [ELSA AG] <support@elsa.de>
  197. Colin Plumb <colin@nyx.net>
  198. Robert Ekl <rekl@megsinet.net>
  199. Hidetaka Hikashi <hikashi@mlb.co.jp>
  200. Hetz Benhamou <hetz@isdn.net.il>
  201. Rick van Rein < vanrein@cs.utwente.nl>
  202. Jeffrey Hutzelman <jhutz+@cmu.edu>
  203. Pavel Roskin <pavel_roskin@geocities.com>
  204. Eugene <bom@classic.iki.rssi.ru>
  205.  
  206. See also
  207. ========
  208.  
  209. Users of isapnptools may be interested in the pnp mailing list
  210. (pnp-list@redhat.com): To subscribe to the mailinglist, simply send a
  211. message with the word "subscribe" in the Subject: field to
  212. pnp-list-request@redhat.com. This list does seem rather quiet now
  213. though.
  214.  
  215. Latest information of isapnptools is available at the time of writing
  216. on my website: http://www.roestock.demon.co.uk/isapnptools/. This
  217. includes an FAQ, and the htmlised manual pages, so please refer to this
  218. first in the event of any difficulties.
  219.  
  220. Peter Fox
  221. 14-Feb-1999
  222.